Carbon


FSMakeFSRefUnicode

Header: Files.h Carbon status: Supported

Constructs an FSRef for an object, given an FSRef for the parent directory, and a Unicode name.

OSErr FSMakeFSRefUnicode (
    const FSRef *parentRef, 
    UniCharCount nameLength, 
    const UniChar *name, 
    TextEncoding textEncodingHint, 
    FSRef *newRef
);
parentRef

A pointer to the FSRef for the directory containing the object (the parent directory).

nameLength

The length of the name, in Unicode characters.

name

A pointer to the Unicode name. The Unicode name must be a leaf name; partial or full pathnames are not allowed. If you have a partial or full pathname in Unicode, you will have to parse it yourself and make multiple FSMakeFSRef calls.

textEncodingHint

A suggested text encoding to use for the name. If you pass kTextEncodingUnknown, the File Manager will use a default value.

newRef

On return, if the result is noErr, a pointer to the new FSRef.

function result

A result code.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)